home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / laserjet.z / laserjet
Text File  |  1998-10-30  |  14KB  |  331 lines
  1.  
  2.  
  3.  
  4. LLLLAAAASSSSEEEERRRRJJJJEEEETTTT((((1111))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       LLLLAAAASSSSEEEERRRRJJJJEEEETTTT((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      laserjet - HP LaserJet parallel printer driver
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _l_a_s_e_r_j_e_t ----PPPP pppprrrriiiinnnntttteeeerrrrnnnnaaaammmmeeee [ options ] [ inputfile ]
  13.  
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      The _l_a_s_e_r_j_e_t driver is a printer-specific driver for a HP LaserJet-series
  17.      printer connected to an SGI /dev/plp-compatible parallel port.  _l_a_s_e_r_j_e_t
  18.      reads STIFF format image files, writes PCL commands to the printer, and
  19.      uses _l_i_b_p_o_d(_3) functions to keep the printer object database (POD)
  20.      current, thereby providing feedback on any engine errors encountered.
  21.  
  22.  
  23.      The driver opens and maintains the POD printer database files for the
  24.      specified printer.  The file <_p_r_i_n_t_e_r_n_a_m_e>._c_o_n_f_i_g contains the detailed
  25.      information on the printer's capabilities, <_p_r_i_n_t_e_r_n_a_m_e>._s_t_a_t_u_s contains
  26.      the information on operational status of the printer, and
  27.      <_p_r_i_n_t_e_r_n_a_m_e>._l_o_g contains the information on print job history.  For
  28.      more information on the POD files refer to the _l_i_b_p_o_d(_3) man page.
  29.  
  30.  
  31.      While _l_a_s_e_r_j_e_t has the parallel port open, no other driver may _f_l_o_c_k(_3)
  32.      the port, thus effectively reserving the printer for exclusive use by
  33.      cooperating drivers.
  34.  
  35.  
  36. IIIINNNNPPPPUUUUTTTT FFFFIIIILLLLEEEE FFFFOOOORRRRMMMMAAAATTTT
  37.      _l_a_s_e_r_j_e_t assumes that its input is coming from its standard input (stdin)
  38.      unless a filename is specified after any and all command line options.
  39.  
  40.      _l_a_s_e_r_j_e_t requires that its input files be in STIFF K 1-bit format.  STIFF
  41.      is a streamable subset of TIFF 6.0.  For more information on the STIFF
  42.      image file format, see the libstiff(3) man pages.
  43.  
  44.  
  45.  
  46. UUUUSSSSAAAAGGGGEEEE
  47.      ----PPPP _p_r_i_n_t_e_r_n_a_m_e
  48.                Specifies the printer with which _l_a_s_e_r_j_e_t is communicating.
  49.                _p_r_i_n_t_e_r_n_a_m_e is the name under which the SystemVR3 spooler
  50.                recognizes the printer, as given on the _l_p command line.  This
  51.                option is required.
  52.  
  53.  
  54.      ----eeee        Specifies that the driver should exit immediately on fault.  By
  55.                default, the driver waits indefinitely for faults to clear,
  56.                retrying any errors every several seconds, where the exact
  57.                number of seconds is defined in the POD config database
  58.                error_retry_wait entry.  This option is useful when only a
  59.                quick inquiry need be performed.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LLLLAAAASSSSEEEERRRRJJJJEEEETTTT((((1111))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       LLLLAAAASSSSEEEERRRRJJJJEEEETTTT((((1111))))
  71.  
  72.  
  73.  
  74.      ----ssss        Specifies that the driver should exit after ascertaining
  75.                printer status and updating the POD status file.  If an error
  76.                is encountered, however, _l_a_s_e_r_j_e_t will block unless the ----eeee
  77.                switch is given as well. If a quick status update is what you
  78.                want, invoke _l_a_s_e_r_j_e_t with both the ----ssss and the ----eeee options to
  79.                insure that _l_a_s_e_r_j_e_t exits promptly.
  80.  
  81.  
  82.      ----wwww        Specify this flag to suppress warning messages in the printer
  83.                status file. By default, warning messages such as "low on ink"
  84.                or other non-fatal errors are written to the printer status
  85.                file.
  86.  
  87.  
  88.      ----DDDD        Turns on debugging information.  Five levels of debugging
  89.                information are supported: none, coarse detail, medium detail,
  90.                fine detail, and extra finer detail.  These correspond to 0, 1,
  91.                2, 3, and 4 or more ----DDDD switches given on the command line.
  92.                That is, multiple ----DDDD options given on the command line result
  93.                in progressively more detailed debugging information.
  94.  
  95.  
  96.      ----tttt        Prints a test page and performs printer diagnostics.  Use this
  97.                to verify that the printer, cables, and driver are functional.
  98.                This option is useful when trying to narrow down the location
  99.                of an error in printing.  If this fails, either the printer,
  100.                the cable, or the driver (including the /dev/plp device driver)
  101.                is at fault, but the model file, print scheduler, and rendering
  102.                filters are not to blame.
  103.  
  104.  
  105.      ----mmmm _m_a_n_u_a_l _f_e_e_d _t_i_m_e_o_u_t (_s_e_c_o_n_d_s)
  106.                Use this to request manual feed.  After waiting _t_i_m_e_o_u_t
  107.                seconds, the driver will instruct the printer to draw paper
  108.                from one of the trays instead of waiting for the user to hand-
  109.                feed paper.  This is important in the case of shared printers,
  110.                so that a negligent user cannot leave the printer without paper
  111.                indefinitely.
  112.  
  113.  
  114.      ----LLLL _l_o_g_f_i_l_e_n_a_m_e
  115.                Specifies a filename to which error and debug information
  116.                should be appended.  If this option is not specified, error and
  117.                debug information is appended to standard error (stderr), which
  118.                is generally redirected by the System V spooler to
  119.                /var/spool/lp/log.
  120.  
  121.  
  122.      ----MMMM _M_a_x_i_m_u_m_C_o_m_p_r_e_s_s_i_o_n_M_o_d_e
  123.                Specifies the highest PCL compression mode which the driver may
  124.                use.  This defaults to PCL compression mode 2.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. LLLLAAAASSSSEEEERRRRJJJJEEEETTTT((((1111))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       LLLLAAAASSSSEEEERRRRJJJJEEEETTTT((((1111))))
  137.  
  138.  
  139.  
  140.      ----RRRR        Reset the parallel port immediately after opening but before
  141.                using it.  This is not the default, but can be a useful feature
  142.                for recalcitrant printers.  Note that some printers ignore the
  143.                RESET signal altogether.  This includes most HP LaserJets.
  144.  
  145.  
  146.      ----3333        Force PCL3 mode.  This disallows any commands specific to PCL4
  147.                or later.  Specifically, PCL3 does not understand number of
  148.                copies commands or any command which would require a full page
  149.                buffer in the printer: no such page buffer is kept in the
  150.                printer.  If this switch is given, multiple copies will be sent
  151.                by complete retransmission rather than a PCL reprint command.
  152.  
  153.  
  154.      ----XXXX _H_o_r_i_z_o_n_t_a_l_R_e_s_o_l_u_t_i_o_n
  155.                Specifies the horizontal resolution at which to print, one of
  156.                the following: 75, 150, 200, 300, or 600.  200 and 600 dpi are
  157.                only supported on the LaserJet 4 printer at this time: other
  158.                printers will default to 300 dpi and printed pages may print
  159.                incorrectly when an unsupported resolution is selected.  This
  160.                is normally derived from the printer status database, but if
  161.                given, it overrides and will be written to the printer status
  162.                database.
  163.  
  164.  
  165.      ----YYYY _V_e_r_t_i_c_a_l_R_e_s_o_l_u_t_i_o_n
  166.                Specifies the vertical resolution at which to print, one of the
  167.                following: 75, 150, 200, 300, or 600.  200 and 600 are only
  168.                supported on the LaserJet 4 printer at this time: other
  169.                printers will default to 300 dpi and printed pages may print
  170.                incorrectly when an unsupported resolution is selected.  This
  171.                is normally derived from the printer status database, but if
  172.                given, it overrides and will be written to the printer status
  173.                database.
  174.  
  175.  
  176.      ----SSSS _P_a_p_e_r_S_i_z_e
  177.                Specifies the papersize to request from the printer.  This may
  178.                be any papersize recognized by libpod(3), but only those sizes
  179.                listed in the printer configuration file should be used.  This
  180.                is normally derived from the printer status database, but if
  181.                given, it overrides and will be written to the printer status
  182.                database.
  183.  
  184.  
  185.      ----OOOO _f_i_l_e_n_a_m_e
  186.                Output data to _f_i_l_e_n_a_m_e instead of the device port or standard
  187.                output.  The data will not be printed; the data that would have
  188.                been sent to the printer had the ----OOOO option not been specified
  189.                will instead be saved to _f_i_l_e_n_a_m_e.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. LLLLAAAASSSSEEEERRRRJJJJEEEETTTT((((1111))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       LLLLAAAASSSSEEEERRRRJJJJEEEETTTT((((1111))))
  203.  
  204.  
  205.  
  206. EEEEXXXXIIIITTTT CCCCOOOODDDDEEEESSSS
  207.      The driver normally exits with an exit code of zero (0), denoting no
  208.      error.  A number of exit codes are supported to give more information
  209.      about unsuccessful exits.  Remember that the driver will not exit on
  210.      recoverable errors unless the ----eeee switch is given.
  211.  
  212.      The error codes 1 through 18 denote the following meanings, in order:
  213.  
  214.           CODE    REASON
  215.              1       unknown error
  216.              2       bad command line or img header args
  217.              3       bad POD database access
  218.              4       bad device name
  219.              5       bad device type
  220.              6       bad status update
  221.              7       unsuccessful device access
  222.              8       bad memory reference
  223.              9       failed memory allocation
  224.              10      invalid data format
  225.              11      invalid data header
  226.              12      short or empty input data file
  227.              13      short or empty firmware code file
  228.              14      bad or short input data file
  229.              15      failed transmission
  230.              16      data buffer invalid
  231.              17      test print failed
  232.              18      firmware download failed.
  233.  
  234.  
  235.      A common error exit is on empty input: the driver will return error code
  236.      12, indicating a short or empty input file, whenever the PostScript
  237.      interpreter (or another upstream filter) dies before a full page of data
  238.      was written to the driver.  This can happen when bad PostScript code is
  239.      sent to be printed, for instance.  In this case, the spooler log file
  240.      (/var/spool/lp/log) should be consulted to determine which filter failed;
  241.      an error should have been written to this file by the dying filter or
  242.      driver.
  243.  
  244.  
  245. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  246.      _l_a_s_e_r_j_e_t will not exit on spooler job cancellation (SIGTERM) until its
  247.      input has been completely copied to the output device.  This means that
  248.      if a printer is unable to accept data, cancelling the job will not kill
  249.      the _l_a_s_e_r_j_e_t process.  To do so, you must explicitly kill the process
  250.      with SIGKILL (9), or reboot the machine.  This behavior is required so
  251.      that job cancellation does not leave the printer in a wedged state:
  252.      cancelling in the middle of a raster page would leave many parallel
  253.      printers in a bad state which could eat several subsequent print jobs.
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. LLLLAAAASSSSEEEERRRRJJJJEEEETTTT((((1111))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       LLLLAAAASSSSEEEERRRRJJJJEEEETTTT((((1111))))
  269.  
  270.  
  271.  
  272. KKKKNNNNOOOOWWWWNNNN BBBBUUUUGGGGSSSS
  273.      Manual feed requests are currently ignored: since the driver does not
  274.      implement manual feed timeouts, manual feed has been disabled.
  275.  
  276.      PCL raster image compression modes 1, 3, 4, 5 are not implemented.  Also
  277.      raster compression could be faster if lines with no data and the blank
  278.      ends of lines were skipped.
  279.  
  280.  
  281. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  282.      impressario(1), printstatus(1), printpanel(1), libpod(3), libspool(3),
  283.      libstiff(3), lp(1)
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.